Description

Draft of REGCA machine-like and REECA exciter-like IBR model specification, which relies on new function primitives in CommonMath . Helps standardize the smooth-ization of the common model components and increases readability. These primitives will be used extensively in the upcoming IBR models.

@abirchfield @BSzymanowski I needed this for the theory section of the HICSS paper ASAP and realized I could construct most of the noncontinuous features with a ramp function primitive. I changed the variable names because the diagram doesn't match my expectations. Let me know what you think, and compare it against any progress you have made on this model, please

@nkoukpaizan Enzyme is starting to make sense to me, so I think I made changes correctly. Please check my CommonMath work!

Proposed changes

• REGCA Model Documentation
• REECA Model Documentation
• CommonMath Primitive functions
  • ramp
  • qramp
• CommonMath Derived functions
  • min
  • max
  • linseg
  • clamp
  • slew
  • antiwindup
• IEEEST refinement using new CommonMath, but also removing the output limiter, which seems to be incorrectly documented in the Power World reference. The functionality appears unclear and inconsistent across different sources. Many do not include it on the IEEEST, so I removed it since it was proving difficult to comply with Enzyme.

Checklist

• All tests pass.
• Code compiles cleanly with flags -Wall -Wpedantic -Wconversion -Wextra.
• The new code follows GridKit™ style guidelines.
• There are unit tests for the new code.
• The new code is documented.
• The feature branch is rebased with respect to the target branch.
• I have updated CHANGELOG.md to reflect the changes in this PR. If this is a minor PR that is part of a larger fix already included in the file, state so.

Further comments

All in preparation for the two IBR models REGCA and REECA, which I have working implementations for.